home *** CD-ROM | disk | FTP | other *** search
/ PC World 2007 September / PCWorld_2007-09_cd.bin / v cisle / smartmont / smartmontools-5.37-1.win32-setup.exe / doc / smartctl.8.txt < prev    next >
Text File  |  2006-12-20  |  75KB  |  1,292 lines

  1. SMARTCTL(8)                       2006/12/20                       SMARTCTL(8)
  2.  
  3.  
  4.  
  5. NAME
  6.        smartctl - Control and Monitor Utility for SMART Disks
  7.  
  8.  
  9. SYNOPSIS
  10.        smartctl [options] device
  11.  
  12.  
  13. FULL PATH
  14.        /usr/local/sbin/smartctl
  15.  
  16.  
  17. PACKAGE VERSION
  18.        smartmontools-5.37 released 2006/12/20 at 20:37:59 UTC
  19.  
  20.  
  21. DESCRIPTION
  22.        smartctl  controls the Self-Monitoring, Analysis and Reporting Technol-
  23.        ogy (SMART) system built into many ATA-3 and later ATA, IDE and  SCSI-3
  24.        hard  drives. The purpose of SMART is to monitor the reliability of the
  25.        hard drive and predict drive failures, and to carry out different types
  26.        of  drive  self-tests.   This  version  of  smartctl is compatible with
  27.        ATA/ATAPI-7 and earlier standards (see REFERENCES below)
  28.  
  29.        smartctl is a command line utility designed to perform SMART tasks such
  30.        as  printing the SMART self-test and error logs, enabling and disabling
  31.        SMART automatic testing, and initiating device self-tests. Note: if the
  32.        user issues a SMART command that is (apparently) not implemented by the
  33.        device, smartctl will print a warning message  but  issue  the  command
  34.        anyway  (see  the -T, --tolerance option below).  This should not cause
  35.        problems: on most devices, unimplemented SMART  commands  issued  to  a
  36.        drive are ignored and/or return an error.
  37.  
  38.        smartctl also provides support for polling TapeAlert messages from SCSI
  39.        tape drives and changers.
  40.  
  41.        The user must specify the device to be controlled  or  interrogated  as
  42.        the final argument to smartctl.  Device paths are as follows:
  43.  
  44.        LINUX:   Use   the   forms  "/dev/hd[a-t]"  for  IDE/ATA  devices,  and
  45.                 "/dev/sd[a-z]" for SCSI devices.  For  SCSI  Tape  Drives  and
  46.                 Changers  with  TapeAlert  support use the devices "/dev/nst*"
  47.                 and "/dev/sg*".  For SATA  disks  accessed  with  libata,  use
  48.                 "/dev/sd[a-z]"  and  append  "-d  ata". For disks behind 3ware
  49.                 controllers you may need "/dev/sd[a-z]" or "/dev/twe[0-9]"  or
  50.                 "/dev/twa[0-9]": see details below. For disks behind HighPoint
  51.                 RocketRAID controllers you may need "/dev/sd[a-z]".  More gen-
  52.                 eral paths (such as devfs ones) may also be specified.
  53.  
  54.        DARWIN:  Use  the  forms  /dev/disk[0-9]  or  equivalently disk[0-9] or
  55.                 equivalently /dev/rdisk[0-9].  Long forms are also  available:
  56.                 please  use '-h' to see some examples. Note that there is cur-
  57.                 rently no Darwin SCSI support.
  58.  
  59.        FREEBSD: Use  the  forms  "/dev/ad[0-9]+"  for  IDE/ATA   devices   and
  60.                 "/dev/da[0-9]+" for SCSI devices.
  61.  
  62.        NETBSD/OPENBSD:
  63.                 Use  the  form "/dev/wd[0-9]+c" for IDE/ATA devices.  For SCSI
  64.                 disk and tape devices, use the device  names  "/dev/sd[0-9]+c"
  65.                 and  "/dev/st[0-9]+c"  respectively.   Be  sure to specify the
  66.                 correct "whole disk" partition letter for your architecture.
  67.  
  68.        SOLARIS: Use the forms "/dev/rdsk/c?t?d?s?" for IDE/ATA and  SCSI  disk
  69.                 devices, and "/dev/rmt/*" for SCSI tape devices.
  70.  
  71.        WINDOWS: Use  the  form  "/dev/hd[a-j]" for IDE/ATA devices "\\.\Physi-
  72.                 calDrive[0-9]" on WinNT4/2000/XP/2003. For IDE/ATA devices  on
  73.                 Win95/98/98SE/ME,  use  "/dev/hd[a-d]"  for  standard  devices
  74.                 accessed via SMARTVSD.VXD, and "/dev/hd[e-h]"  for  additional
  75.                 devices  accessed via a patched SMARTVSE.VXD (see INSTALL file
  76.                 for details).  Use the  form  "/dev/scsi[0-9][0-f]"  for  SCSI
  77.                 devices via an aspi dll on ASPI adapter 0-9, ID 0-15. Alterna-
  78.                 tively  use  "/dev/sd[a-z]"   for   SCSI   disks   "\\.\Physi-
  79.                 calDrive[0-25]"  on  WinNT4/2000/XP/2003  (where  "a"  maps to
  80.                 "0"). SCSI disks can also be referred to  as  "/dev/pd[0-255]"
  81.                 for "\\.\PhysicalDrive[0-255]" on WinNT4/2000/XP/2003. Use the
  82.                 form "/dev/tape[0-255]" for SCSI tape drives "\\.\Tape[0-255]"
  83.                 on  WinNT4/2000/XP/2003.   For  disks  behind  3ware 9000 con-
  84.                 trollers use "/dev/hd[a-j],N" where N specifies the disk  num-
  85.                 ber (3ware 'port') behind the controller providing the logical
  86.                 drive ('unit') specified  by  "/dev/hd[a-j]".   Alternatively,
  87.                 use  "/dev/tw_cli/cx/py"  for  controller x, port y to run the
  88.                 'tw_cli' tool and parse the output. This provides limited mon-
  89.                 itoring  ('-i',  '-c', '-A' below) if SMART support is missing
  90.                 in the driver. Use "/dev/tw_cli/stdin"  or  "/dev/tw_cli/clip"
  91.                 to  parse  CLI or 3DM output from standard input or clipboard.
  92.                 The option '-d 3ware,N' is not necessary on Windows.  The pre-
  93.                 fix "/dev/" is optional.
  94.  
  95.        CYGWIN:  See "WINDOWS" above.
  96.  
  97.        OS/2,eComStation:
  98.                 Use the form "/dev/hd[a-z]" for IDE/ATA devices.
  99.  
  100.        Based  on  the device path, smartctl will guess the device type (ATA or
  101.        SCSI).  If necessary, the '-d' option can be  used  to  over-ride  this
  102.        guess
  103.  
  104.        Note that the printed output of smartctl displays most numerical values
  105.        in base 10 (decimal), but some values are displayed in  base  16  (hex-
  106.        adecimal).   To  distinguish  them,  the base 16 values are always dis-
  107.        played with a leading "0x", for example: "0xff". This man page  follows
  108.        the same convention.
  109.  
  110.  
  111.  
  112. OPTIONS
  113.        The  options  are grouped below into several categories.  smartctl will
  114.        execute  the  corresponding  commands  in   the   order:   INFORMATION,
  115.        ENABLE/DISABLE, DISPLAY DATA, RUN/ABORT TESTS.
  116.  
  117.        SCSI devices only accept the options -h, -V, -i, -a, -A, -d, -s, -S,-H,
  118.        -t, -C, -l background, -l error, -l selftest, -r,  and  -X.   TapeAlert
  119.        devices  only accept the options -h, -V, -i, -a, -A, -d, -s, -S, -t, -l
  120.        error, -l selftest, -r, and -H.
  121.  
  122.        Long options  are  not  supported  on  all   systems.    Use  'smartctl
  123.        -h' to see the available options.
  124.  
  125.  
  126.        SHOW INFORMATION OPTIONS:
  127.  
  128.        -h, --help, --usage
  129.               Prints a usage message to STDOUT and exits.
  130.  
  131.        -V, --version, --copyright, --license
  132.               Prints  version, copyright, license, home page and CVS-id infor-
  133.               mation for your copy of  smartctl  to  STDOUT  and  then  exits.
  134.               Please  include  this  information  if you are reporting bugs or
  135.               problems.
  136.  
  137.        -i, --info
  138.               Prints the device model number, serial number, firmware version,
  139.               and  ATA  Standard  version/revision  information.   Says if the
  140.               device supports SMART, and if so, whether SMART support is  cur-
  141.               rently  enabled  or  disabled.   If  the device supports Logical
  142.               Block Address mode (LBA mode) print current user drive  capacity
  143.               in bytes. (If drive is has a user protected area reserved, or is
  144.               "clipped", this may be smaller than the potential maximum  drive
  145.               capacity.)   Indicates  if  the  drive  is  in the smartmontools
  146.               database (see '-v' options below).  If so, the drive model  fam-
  147.               ily  may  also be printed. If '-n' (see below) is specified, the
  148.               power mode of the drive is printed.
  149.  
  150.        -a, --all
  151.               Prints all SMART information about the disk, or TapeAlert infor-
  152.               mation about the tape drive or changer.  For ATA devices this is
  153.               equivalent to
  154.               '-H -i -c -A -l error -l selftest -l selective'
  155.               and for SCSI, this is equivalent to
  156.               '-H -i -A -l error -l selftest'.
  157.               Note that for ATA disks this does not enable the '-l  directory'
  158.               option.
  159.  
  160.  
  161.        RUN-TIME BEHAVIOR OPTIONS:
  162.  
  163.        -q TYPE, --quietmode=TYPE
  164.               Specifies that smartctl should run in one of the two quiet modes
  165.               described here.  The valid arguments to this option are:
  166.  
  167.               errorsonly - only print: For the '-l error' option, if  nonzero,
  168.               the  number  of  errors  recorded in the SMART error log and the
  169.               power-on time when they occurred; For the '-l selftest'  option,
  170.               errors  recorded  in  the  device  self-test  log;  For the '-H'
  171.               option,  SMART  "disk  failing"  status  or  device   Attributes
  172.               (pre-failure  or  usage) which failed either now or in the past;
  173.               For the '-A' option, device Attributes  (pre-failure  or  usage)
  174.               which failed either now or in the past.
  175.  
  176.               silent  - print no output.  The only way to learn about what was
  177.               found is to use the exit status of smartctl (see  RETURN  VALUES
  178.               below).
  179.  
  180.        -d TYPE, --device=TYPE
  181.               Specifies  the  type of the device.  The valid arguments to this
  182.               option are  ata,  scsi,  sat,  marvell,  3ware,N,  and  hpt,L/M,
  183.               cciss,N  or hpt,L/M/N.  If this option is not used then smartctl
  184.               will attempt to guess the device type from the device name.
  185.  
  186.               The 'sat' device type is for ATA disks that have a SCSI  to  ATA
  187.               Translation  (SAT) Layer (SATL) between the disk and the operat-
  188.               ing system.  SAT defines two ATA PASS THROUGH SCSI commands, one
  189.               12  bytes  long  and  the other 16 bytes long that smartctl will
  190.               utilize when this device type is selected. The default is the 16
  191.               byte  variant which can be overridden with either '-d sat,12' or
  192.               '-d sat,16'.
  193.  
  194.               Under Linux, to look at SATA  disks  behind  Marvell  SATA  con-
  195.               trollers  (using  Marvell's 'linuxIAL' driver rather than libata
  196.               driver) use '-d marvell'. Such controllers show  up  as  Marvell
  197.               Technology  Group  Ltd. SATA I or II controllers using lspci, or
  198.               using lspci -n show a vendor ID 0x11ab and a device ID of either
  199.               0x5040, 0x5041, 0x5080, 0x5081, 0x6041 or 0x6081. The 'linuxIAL'
  200.               driver seems not (yet?) available in  the  Linux  kernel  source
  201.               tree,    but   should   be   available   from   system   vendors
  202.               (ftp://ftp.aslab.com/ is known  to  provide  a  patch  with  the
  203.               driver).
  204.  
  205.               Under  Linux and FreeBSD, to look at ATA disks behind 3ware SCSI
  206.               RAID controllers, use syntax such as:
  207.               smartctl -a -d 3ware,2 /dev/sda
  208.               smartctl -a -d 3ware,0 /dev/twe0
  209.               smartctl -a -d 3ware,1 /dev/twa0
  210.               where in the argument 3ware,N, the integer N is the disk  number
  211.               (3ware  'port')  within  the  3ware  ATA  RAID  controller.  The
  212.               allowed values of N are from 0 to 15 inclusive.  The  first  two
  213.               forms,  which  refer to devices /dev/sda-z and /dev/twe0-15, may
  214.               be used with 3ware series  6000,  7000,  and  8000  series  con-
  215.               trollers  that use the 3x-xxxx driver.  Note that the /dev/sda-z
  216.               form is deprecated starting with the Linux 2.6 kernel series and
  217.               may not be supported by the Linux kernel in the near future. The
  218.               final form, which refers to devices /dev/twa0-15, must  be  used
  219.               with  3ware  9000  series  controllers,  which  use  the 3w-9xxx
  220.               driver.
  221.  
  222.               Note that if the special character device  nodes  /dev/twa?  and
  223.               /dev/twe?  do  not  exist,  or exist with the incorrect major or
  224.               minor numbers, smartctl will recreate them on  the  fly.   Typi-
  225.               cally  /dev/twa0  refers  to  the  first 9000-series controller,
  226.               /dev/twa1 refers to the second 9000 series  controller,  and  so
  227.               on.  Likewise /dev/twe0 refers to the first 6/7/8000-series con-
  228.               troller, /dev/twa1 refers to the  second  6/7/8000  series  con-
  229.               troller, and so on.
  230.  
  231.               Note  that  for  the  6/7/8000  controllers, any of the physical
  232.               disks can be queried or examined using any of the  3ware's  SCSI
  233.               logical  device  /dev/sd?   entries.   Thus,  if  logical device
  234.               /dev/sda is made up of two physical disks (3ware ports zero  and
  235.               one)  and logical device /dev/sdb is made up of two other physi-
  236.               cal disks (3ware ports two and three) then you can  examine  the
  237.               SMART  data  on any of the four physical disks using either SCSI
  238.               device /dev/sda or /dev/sdb.  If you need to know which  logical
  239.               SCSI  device  a particular physical disk (3ware port) is associ-
  240.               ated with, use the dmesg or SYSLOG output to show which SCSI  ID
  241.               corresponds  to  a particular 3ware unit, and then use the 3ware
  242.               CLI or 3dm tool to determine which ports (physical disks) corre-
  243.               spond to particular 3ware units.
  244.  
  245.               If  the  value of N corresponds to a port that does not exist on
  246.               the 3ware controller, or to a port that does not physically have
  247.               a disk attached to it, the behavior of smartctl depends upon the
  248.               specific controller model, firmware, Linux kernel and  platform.
  249.               In  some  cases  you  will get a warning message that the device
  250.               does not exist. In other cases you will be presented with 'void'
  251.               data for a non-existent device.
  252.  
  253.               Note  that  if  the /dev/sd? addressing form is used, then older
  254.               3w-xxxx drivers do not pass the "Enable Autosave" ('-S on')  and
  255.               "Enable  Automatic  Offline" ('-o on') commands to the disk, and
  256.               produce these types of harmless syslog error  messages  instead:
  257.               "3w-xxxx:  tw_ioctl(): Passthru size (123392) too big". This can
  258.               be fixed by upgrading to version 1.02.00.037  or  later  of  the
  259.               3w-xxxx  driver,  or  by applying a patch to older versions. See
  260.               http://smartmontools.sourceforge.net/ for instructions.   Alter-
  261.               natively, use the character device /dev/twe0-15 interface.
  262.  
  263.               The  selective  self-test  functions  ('-t select,A-B') are only
  264.               supported using the character device interface /dev/twa0-15  and
  265.               /dev/twe0-15.   The  necessary  WRITE  LOG  commands  can not be
  266.               passed through the SCSI interface.
  267.  
  268.               3ware controllers are supported under Linux,  FreeBSD  and  Win-
  269.               dows.
  270.  
  271.               To look at (S)ATA disks behind HighPoint RocketRAID controllers,
  272.               use syntax such as:
  273.               smartctl -a -d hpt,1/3 /dev/sda
  274.               or
  275.               smartctl -a -d hpt,1/2/3 /dev/sda
  276.               where in the argument hpt,L/M or hpt,L/M/N, the integer L is the
  277.               controller  id,  the  integer  M  is the channel number, and the
  278.               integer N is the PMPort number if it is available.  The  allowed
  279.               values  of L are from 1 to 4 inclusive, M are from 1 to 8 inclu-
  280.               sive and N from 1 to 4  if  PMPort  available.   Note  that  the
  281.               /dev/sda-z  form  should be the device node which stands for the
  282.               disks derived from the HighPoint  RocketRAID  controllers.   And
  283.               also  these  values  are  limited  by the model of the HighPoint
  284.               RocketRAID controller.
  285.  
  286.               HighPoint RocketRAID controllers are  currently  ONLY  supported
  287.               under Linux.
  288.  
  289.               cciss controllers are currently ONLY supported under Linux.
  290.  
  291.  
  292.        -T TYPE, --tolerance=TYPE
  293.               Specifies  how tolerant smartctl should be of ATA and SMART com-
  294.               mand failures.
  295.  
  296.               The behavior of smartctl depends upon  whether  the  command  is
  297.               "optional"  or  "mandatory". Here "mandatory" means "required by
  298.               the ATA/ATAPI-5 Specification if the device implements the SMART
  299.               command   set"   and  "optional"  means  "not  required  by  the
  300.               ATA/ATAPI-5 Specification even  if  the  device  implements  the
  301.               SMART command set."  The "mandatory" ATA and SMART commands are:
  302.               (1) ATA IDENTIFY  DEVICE,  (2)  SMART  ENABLE/DISABLE  ATTRIBUTE
  303.               AUTOSAVE, (3) SMART ENABLE/DISABLE, and (4) SMART RETURN STATUS.
  304.  
  305.               The valid arguments to this option are:
  306.  
  307.               normal - exit on failure of any  mandatory  SMART  command,  and
  308.               ignore  all  failures  of  optional SMART commands.  This is the
  309.               default.  Note  that  on  some  devices,  issuing  unimplemented
  310.               optional SMART commands doesn't cause an error.  This can result
  311.               in misleading smartctl messages such as "Feature  X  not  imple-
  312.               mented", followed shortly by "Feature X: enabled".  In most such
  313.               cases, contrary to the final message, Feature X is not  enabled.
  314.  
  315.               conservative - exit on failure of any optional SMART command.
  316.  
  317.               permissive  -  ignore  failure(s)  of  mandatory SMART commands.
  318.               This option may be given more than once.  Each additional use of
  319.               this  option  will  cause  one  more  additional  failure  to be
  320.               ignored.  Note that the use of this option can lead to  messages
  321.               like  "Feature  X  not implemented", followed shortly by "Error:
  322.               unable to enable Feature X".  In a few such cases,  contrary  to
  323.               the final message, Feature X is enabled.
  324.  
  325.               verypermissive - equivalent to giving a large number of '-T per-
  326.               missive' options: ignore failures of  any  number  of  mandatory
  327.               SMART commands.  Please see the note above.
  328.  
  329.  
  330.        -b TYPE, --badsum=TYPE
  331.               Specifies the action smartctl should take if a checksum error is
  332.               detected in  the:  (1)  Device  Identity  Structure,  (2)  SMART
  333.               Self-Test  Log  Structure,  (3) SMART Attribute Value Structure,
  334.               (4) SMART Attribute Threshold Structure, or (5)  ATA  Error  Log
  335.               Structure.
  336.  
  337.               The valid arguments to this option are:
  338.  
  339.               warn  -  report  the incorrect checksum but carry on in spite of
  340.               it.  This is the default.
  341.  
  342.               exit - exit smartctl.
  343.  
  344.               ignore - continue silently without issuing a warning.
  345.  
  346.  
  347.        -r TYPE, --report=TYPE
  348.               Intended primarily to help smartmontools  developers  understand
  349.               the  behavior  of smartmontools on non-conforming or poorly con-
  350.               forming hardware.   This  option  reports  details  of  smartctl
  351.               transactions  with  the device.  The option can be used multiple
  352.               times.  When used just once, it shows a record  of  the  ioctl()
  353.               transactions  with  the  device.   When used more than once, the
  354.               detail of these ioctl() transactions  are  reported  in  greater
  355.               detail.  The valid arguments to this option are:
  356.  
  357.               ioctl - report all ioctl() transactions.
  358.  
  359.               ataioctl - report only ioctl() transactions with ATA devices.
  360.  
  361.               scsiioctl  - report only ioctl() transactions with SCSI devices.
  362.               Invoking this once shows the SCSI commands in hex and the corre-
  363.               sponding status. Invoking it a second time adds a hex listing of
  364.               the first 64 bytes of data send to, or received from the device.
  365.  
  366.               Any argument may include a positive integer to specify the level
  367.               of detail that should be reported.  The argument should be  fol-
  368.               lowed  by a comma then the integer with no spaces.  For example,
  369.               ataioctl,2 The default level is 1, so '-r  ataioctl,1'  and  '-r
  370.               ataioctl' are equivalent.
  371.  
  372.  
  373.        -n POWERMODE, --nocheck=POWERMODE
  374.               Specifieds  if smartctl should exit before performing any checks
  375.               when the device is in a low-power mode. It may be used  to  pre-
  376.               vent  a  disk  from being spun-up by smartctl. The power mode is
  377.               ignored by default. The allowed values of POWERMODE are:
  378.  
  379.               never - check the device always, but print  the  power  mode  if
  380.               '-i' is specified.
  381.  
  382.               sleep - check the device unless it is in SLEEP mode.
  383.  
  384.               standby  -  check  the  device  unless it is in SLEEP or STANDBY
  385.               mode.  In these modes most disks are not  spinning,  so  if  you
  386.               want  to  prevent a disk from spinning up, this is probably what
  387.               you want.
  388.  
  389.               idle - check the device unless it is in SLEEP, STANDBY  or  IDLE
  390.               mode.  In the IDLE state, most disks are still spinning, so this
  391.               is probably not what you want.
  392.  
  393.  
  394.        SMART FEATURE ENABLE/DISABLE COMMANDS:
  395.  
  396.               Note: if multiple options are used to both enable and disable  a
  397.               feature,  then  both  the  enable  and  disable commands will be
  398.               issued.  The enable command will always  be  issued  before  the
  399.               corresponding disable command.
  400.  
  401.        -s VALUE, --smart=VALUE
  402.               Enables  or  disables  SMART  on device.  The valid arguments to
  403.               this option are on and off.   Note  that  the  command  '-s  on'
  404.               (perhaps  used with with the '-o on' and '-S on' options) should
  405.               be placed in a start-up script for your machine, for example  in
  406.               rc.local or rc.sysinit.  In principle the SMART feature settings
  407.               are preserved over power-cycling, but  it  doesn't  hurt  to  be
  408.               sure. It is not necessary (or useful) to enable SMART to see the
  409.               TapeAlert messages.
  410.  
  411.        -o VALUE, --offlineauto=VALUE
  412.               Enables or disables SMART automatic offline  test,  which  scans
  413.               the drive every four hours for disk defects. This command can be
  414.               given during normal system operation.  The  valid  arguments  to
  415.               this option are on and off.
  416.  
  417.               Note  that the SMART automatic offline test command is listed as
  418.               "Obsolete" in every version of the ATA and ATA/ATAPI  Specifica-
  419.               tions.   It  was  originally  part of the SFF-8035i Revision 2.0
  420.               specification, but was never  part  of  any  ATA  specification.
  421.               However  it is implemented and used by many vendors. [Good docu-
  422.               mentation can be found in IBM's Official Published Disk Specifi-
  423.               cations.   For  example the IBM Travelstar 40GNX Hard Disk Drive
  424.               Specifications (Revision 1.1, 22 April 2002, Publication # 1541,
  425.               Document S07N-7715-02) page 164. You can also read the SFF-8035i
  426.               Specification -- see REFERENCES below.]  You can tell  if  auto-
  427.               matic  offline  testing  is  supported by seeing if this command
  428.               enables and disables it, as indicated by the 'Auto Offline  Data
  429.               Collection'  part  of  the  SMART capabilities report (displayed
  430.               with '-c').
  431.  
  432.               SMART provides three basic categories  of  testing.   The  first
  433.               category,  called "online" testing, has no effect on the perfor-
  434.               mance of the device.  It is turned on by the '-s on' option.
  435.  
  436.               The second category of testing is called "offline" testing. This
  437.               type  of test can, in principle, degrade the device performance.
  438.               The '-o on' option causes this offline  testing  to  be  carried
  439.               out, automatically, on a regular scheduled basis.  Normally, the
  440.               disk will suspend offline testing while disk accesses are taking
  441.               place, and then automatically resume it when the disk would oth-
  442.               erwise be idle, so in practice it has little effect.  Note  that
  443.               a one-time offline test can also be carried out immediately upon
  444.               receipt of a user command.  See the '-t offline'  option  below,
  445.               which  causes  a one-time offline test to be carried out immedi-
  446.               ately.
  447.  
  448.               The choice (made by the SFF-8035i and ATA specification authors)
  449.               of  the  word testing for these first two categories is unfortu-
  450.               nate, and often leads to confusion.  In  fact  these  first  two
  451.               categories  of  online  and offline testing could have been more
  452.               accurately described as online and offline data collection.
  453.  
  454.               The results of this automatic or immediate offline testing (data
  455.               collection) are reflected in the values of the SMART Attributes.
  456.               Thus, if problems or errors are detected, the  values  of  these
  457.               Attributes will go below their failure thresholds; some types of
  458.               errors may also appear in the SMART error log. These are visible
  459.               with the '-A' and '-l error' options respectively.
  460.  
  461.               Some  SMART  attribute  values  are updated only during off-line
  462.               data collection activities; the rest are updated  during  normal
  463.               operation  of  the  device  or  during both normal operation and
  464.               off-line testing.  The Attribute value  table  produced  by  the
  465.               '-A' option indicates this in the UPDATED column.  Attributes of
  466.               the first type are labeled "Offline" and Attributes of the  sec-
  467.               ond type are labeled "Always".
  468.  
  469.               The  third  category of testing (and the only category for which
  470.               the word 'testing' is really an appropriate  choice)  is  "self"
  471.               testing.   This  third  type  of test is only performed (immedi-
  472.               ately) when a command to run it is issued.  The  '-t'  and  '-X'
  473.               options  can  be  used  to  carry out and abort such self-tests;
  474.               please see below for further details.
  475.  
  476.               Any errors detected in the self testing will  be  shown  in  the
  477.               SMART  self-test  log, which can be examined using the '-l self-
  478.               test' option.
  479.  
  480.               Note: in this manual page, the word "Test" is used in connection
  481.               with  the second category just described, e.g. for the "offline"
  482.               testing.  The words "Self-test" are used in connection with  the
  483.               third category.
  484.  
  485.        -S VALUE, --saveauto=VALUE
  486.               Enables  or  disables  SMART  autosave of device vendor-specific
  487.               Attributes. The valid arguments to this option are on  and  off.
  488.               Note that this feature is preserved across disk power cycles, so
  489.               you should only need to issue it once.
  490.  
  491.               For SCSI devices this toggles the value of  the  Global  Logging
  492.               Target  Save Disabled (GLTSD) bit in the Control Mode Page. Some
  493.               disk manufacturers set this bit by default. This prevents  error
  494.               counters, power-up hours and other useful data from being placed
  495.               in non-volatile storage, so these values may be  reset  to  zero
  496.               the  next  time the device is power-cycled.  If the GLTSD bit is
  497.               set then 'smartctl -a' will issue a warning. Use on to clear the
  498.               GLTSD  bit and thus enable saving counters to non-volatile stor-
  499.               age. For extreme streaming-video  type  applications  you  might
  500.               consider using off to set the GLTSD bit.
  501.  
  502.  
  503.        SMART READ AND DISPLAY DATA OPTIONS:
  504.  
  505.        -H, --health
  506.               Check: Ask the device to report its SMART health status or pend-
  507.               ing TapeAlert messages.  SMART status is  based  on  information
  508.               that  it  has gathered from online and offline tests, which were
  509.               used to determine/update  its  SMART  vendor-specific  Attribute
  510.               values.  TapeAlert  status  is obtained by reading the TapeAlert
  511.               log page.
  512.  
  513.               If the device reports failing health status, this  means  either
  514.               that the device has already failed, or that it is predicting its
  515.               own failure within the next 24 hours.  If this happens, use  the
  516.               '-a'  option  to get more information, and get your data off the
  517.               disk and someplace safe as soon as you can.
  518.  
  519.        -c, --capabilities
  520.               Prints only the generic SMART  capabilities.   These  show  what
  521.               SMART  features  are implemented and how the device will respond
  522.               to some of the different SMART commands.  For example  it  shows
  523.               if  the device logs errors, if it supports offline surface scan-
  524.               ning, and so on.  If the device can carry out  self-tests,  this
  525.               option  also  shows  the  estimated  time  required to run those
  526.               tests.
  527.  
  528.               Note that the time required to run  the  Self-tests  (listed  in
  529.               minutes)  are fixed.  However the time required to run the Imme-
  530.               diate Offline Test (listed in seconds) is variable.  This  means
  531.               that if you issue a command to perform an Immediate Offline test
  532.               with the '-t offline' option, then the time may jump to a larger
  533.               value  and then count down as the Immediate Offline Test is car-
  534.               ried out.  Please see REFERENCES below for  further  information
  535.               about the the flags and capabilities described by this option.
  536.  
  537.        -A, --attributes
  538.               Prints   only   the   vendor  specific  SMART  Attributes.   The
  539.               Attributes are numbered from 1 to 253 and  have  specific  names
  540.               and ID numbers. For example Attribute 12 is "power cycle count":
  541.               how many times has the disk been powered up.
  542.  
  543.               Each Attribute has a "Raw"  value,  printed  under  the  heading
  544.               "RAW_VALUE",  and a "Normalized" value printed under the heading
  545.               "VALUE".  [Note: smartctl prints these values in  base-10.]   In
  546.               the  example  just given, the "Raw Value" for Attribute 12 would
  547.               be  the  actual  number  of  times  that  the  disk   has   been
  548.               power-cycled,  for  example  365  if the disk has been turned on
  549.               once per day for exactly one year.  Each vendor uses  their  own
  550.               algorithm to convert this "Raw" value to a "Normalized" value in
  551.               the range from 1 to 254.  Please keep in mind that smartctl only
  552.               reports the different Attribute types, values, and thresholds as
  553.               read from the device.  It does  not  carry  out  the  conversion
  554.               between  "Raw"  and  "Normalized"  values:  this  is done by the
  555.               disk's firmware.
  556.  
  557.               The conversion from Raw value to a quantity with physical  units
  558.               is  not specified by the SMART standard. In most cases, the val-
  559.               ues printed by smartctl are sensible.  For example the  tempera-
  560.               ture Attribute generally has its raw value equal to the tempera-
  561.               ture in Celsius.  However in some cases vendors use unusual con-
  562.               ventions.  For example the Hitachi disk on my laptop reports its
  563.               power-on hours in minutes, not hours. Some IBM disks track three
  564.               temperatures rather than one, in their raw values.  And so on.
  565.  
  566.               Each  Attribute  also has a Threshold value (whose range is 0 to
  567.               255) which is printed under the heading "THRESH".  If  the  Nor-
  568.               malized value is less than or equal to the Threshold value, then
  569.               the Attribute is said to have failed.  If  the  Attribute  is  a
  570.               pre-failure Attribute, then disk failure is imminent.
  571.  
  572.               Each  Attribute also has a "Worst" value shown under the heading
  573.               "WORST".  This is the smallest (closest to failure)  value  that
  574.               the disk has recorded at any time during its lifetime when SMART
  575.               was enabled.  [Note however that some vendors firmware may actu-
  576.               ally   increase   the   "Worst"   value   for  some  "rate-type"
  577.               Attributes.]
  578.  
  579.               The Attribute table printed  out  by  smartctl  also  shows  the
  580.               "TYPE"  of  the  Attribute.  Attributes  are one of two possible
  581.               types: Pre-failure or Old age.  Pre-failure Attributes are  ones
  582.               which, if less than or equal to their threshold values, indicate
  583.               pending disk failure.  Old age, or usage  Attributes,  are  ones
  584.               which  indicate end-of-product life from old-age or normal aging
  585.               and wearout, if the Attribute value is less than or equal to the
  586.               threshold.   Please  note: the fact that an Attribute is of type
  587.               'Pre-fail' does not mean that your disk is about  to  fail!   It
  588.               only  has  this  meaning  if  the Attribute's current Normalized
  589.               value is less than or equal to the threshold value.
  590.  
  591.               If the Attribute's current Normalized  value  is  less  than  or
  592.               equal to the threshold value, then the "WHEN_FAILED" column will
  593.               display "FAILING_NOW". If not, but the worst recorded  value  is
  594.               less than or equal to the threshold value, then this column will
  595.               display "In_the_past".  If the "WHEN_FAILED" column has no entry
  596.               (indicated  by  a  dash: '-') then this Attribute is OK now (not
  597.               failing) and has also never failed in the past.
  598.  
  599.               The table column labeled "UPDATED" shows if the SMART  Attribute
  600.               values  are  updated  during  both normal operation and off-line
  601.               testing, or only during offline testing.  The former are labeled
  602.               "Always" and the latter are labeled "Offline".
  603.  
  604.               So  to  summarize:  the  Raw  Attribute values are the ones that
  605.               might have a real physical interpretation, such as  "Temperature
  606.               Celsius",  "Hours",  or  "Start-Stop Cycles".  Each manufacturer
  607.               converts these, using their detailed  knowledge  of  the  disk's
  608.               operations  and failure modes, to Normalized Attribute values in
  609.               the range 1-254.  The current and  worst  (lowest  measured)  of
  610.               these  Normalized Attribute values are stored on the disk, along
  611.               with a Threshold value that the manufacturer has determined will
  612.               indicate that the disk is going to fail, or that it has exceeded
  613.               its design age or aging limit.  smartctl does not calculate  any
  614.               of the Attribute values, thresholds, or types, it merely reports
  615.               them from the SMART data on the device.
  616.  
  617.               Note that starting with ATA/ATAPI-4, revision 4, the meaning  of
  618.               these  Attribute  fields has been made entirely vendor-specific.
  619.               However most ATA/ATAPI-5 disks seem to respect their meaning, so
  620.               we have retained the option of printing the Attribute values.
  621.  
  622.               For SCSI devices the "attributes" are obtained from the tempera-
  623.               ture and start-stop cycle counter log pages. Certain vendor spe-
  624.               cific  attributes  are  listed if recognised. The attributes are
  625.               output in a relatively  free  format  (compared  with  ATA  disk
  626.               attributes).
  627.  
  628.        -l TYPE, --log=TYPE
  629.               Prints  either the SMART Error Log, the SMART Self-Test Log, the
  630.               SMART Selective Self-Test Log [ATA only], the Log Directory [ATA
  631.               only],  or  the  Background  Scan  Results Log [SCSI only].  The
  632.               valid arguments to this option are:
  633.  
  634.               error - prints only the SMART error log.  SMART disks maintain a
  635.               log  of  the  most  recent  five non-trivial errors. For each of
  636.               these errors, the disk power-on  lifetime  at  which  the  error
  637.               occurred  is  recorded,  as is the device status (idle, standby,
  638.               etc) at the time of the error.  For some common types of errors,
  639.               the  Error  Register  (ER)  and  Status Register (SR) values are
  640.               decoded and printed as text. The meanings of these are:
  641.                  ABRT:  Command ABoRTed
  642.                  AMNF:  Address Mark Not Found
  643.                  CCTO:  Command Completion Timed Out
  644.                  EOM:   End Of Media
  645.                  ICRC:  Interface Cyclic Redundancy Code (CRC) error
  646.                  IDNF:  IDentity Not Found
  647.                  ILI:   (packet command-set specific)
  648.                  MC:    Media Changed
  649.                  MCR:   Media Change Request
  650.                  NM:    No Media
  651.                  obs:   obsolete
  652.                  TK0NF: TracK 0 Not Found
  653.                  UNC:   UNCorrectable Error in Data
  654.                  WP:    Media is Write Protected
  655.               In addition, up to the last  five  commands  that  preceded  the
  656.               error are listed, along with a timestamp measured from the start
  657.               of the corresponding power cycle. This is displayed in the  form
  658.               Dd+HH:MM:SS.msec  where D is the number of days, HH is hours, MM
  659.               is minutes, SS is seconds and msec is milliseconds.  [Note: this
  660.               time  stamp wraps after 2^32 milliseconds, or 49 days 17 hours 2
  661.               minutes and 47.296 seconds.]  The key  ATA  disk  registers  are
  662.               also  recorded in the log.  The final column of the error log is
  663.               a text-string description of the ATA command defined by the Com-
  664.               mand  Register  (CR) and Feature Register (FR) values.  Commands
  665.               that are obsolete in the most current (ATA-7)  spec  are  listed
  666.               like  this:  READ  LONG  (w/ retry) [OBS-4], indicating that the
  667.               command became obsolete with  or  in  the  ATA-4  specification.
  668.               Similarly,  the notation [RET-N] is used to indicate that a com-
  669.               mand was retired in the ATA-N specification.  Some commands  are
  670.               not  defined  in any version of the ATA specification but are in
  671.               common use nonetheless; these are marked [NS], meaning non-stan-
  672.               dard.
  673.  
  674.               The  ATA  Specification  (ATA-5 Revision 1c, Section 8.41.6.8.2)
  675.               says: "Error log  structures  shall  include  UNC  errors,  IDNF
  676.               errors  for which the address requested was valid, servo errors,
  677.               write fault errors, etc.  Error log data  structures  shall  not
  678.               include errors attributed to the receipt of faulty commands such
  679.               as command codes not implemented by the device or requests  with
  680.               invalid  parameters  or  invalid  addresses." The definitions of
  681.               these terms are:
  682.               UNC (UNCorrectable): data is uncorrectable.  This refers to data
  683.               which  has  been  read  from  the  disk, but for which the Error
  684.               Checking  and  Correction  (ECC)  codes  are  inconsistent.   In
  685.               effect, this means that the data can not be read.
  686.               IDNF (ID Not Found): user-accessible address could not be found.
  687.               For READ LOG type commands, IDNF can also indicate that a device
  688.               data log structure checksum was incorrect.
  689.  
  690.               If  the  command  that caused the error was a READ or WRITE com-
  691.               mand, then the Logical Block Address (LBA) at  which  the  error
  692.               occurred  will  be printed in base 10 and base 16.  The LBA is a
  693.               linear address, which  counts  512-byte  sectors  on  the  disk,
  694.               starting  from  zero.   (Because of the limitations of the SMART
  695.               error log, if the LBA is greater than 0xfffffff, then either  no
  696.               error  log  entry will be made, or the error log entry will have
  697.               an incorrect LBA. This may happen for  drives  with  a  capacity
  698.               greater  than 128 GiB or 137 GB.) On Linux systems the smartmon-
  699.               tools web page has instructions about how  to  convert  the  LBA
  700.               address  to  the  name of the disk file containing the erroneous
  701.               disk sector.
  702.  
  703.               Please note that some manufacturers ignore  the  ATA  specifica-
  704.               tions,  and make entries in the error log if the device receives
  705.               a command which is not implemented or is not valid.
  706.  
  707.               error [SCSI] - prints the error counter  log  pages  for  reads,
  708.               write  and verifies.  The verify row is only output if it has an
  709.               element other than zero.
  710.  
  711.               selftest - prints the SMART self-test log.  The disk maintains a
  712.               self-test  log  showing the results of the self tests, which can
  713.               be run using the '-t' option described below.  For each  of  the
  714.               most  recent  twenty-one  self-tests,  the log shows the type of
  715.               test (short or extended, off-line or captive) and the final sta-
  716.               tus  of  the  test.   If the test did not complete successfully,
  717.               then the percentage of the test remaining is shown.  The time at
  718.               which  the  test took place, measured in hours of disk lifetime,
  719.               is also printed.  If any errors were detected, the Logical Block
  720.               Address (LBA) of the first error is printed in decimal notation.
  721.               On Linux systems the smartmontools  web  page  has  instructions
  722.               about  how  to  convert this LBA address to the name of the disk
  723.               file containing the erroneous block.
  724.  
  725.               selftest [SCSI] - the self-test log for  a  SCSI  device  has  a
  726.               slightly  different  format than for an ATA device.  For each of
  727.               the most recent twenty self-tests, it shows the type of test and
  728.               the  status  (final  or in progress) of the test. SCSI standards
  729.               use the terms "foreground" and "background" (rather  than  ATA's
  730.               corresponding  "captive"  and "off-line") and "short" and "long"
  731.               (rather than ATA's  corresponding  "short"  and  "extended")  to
  732.               describe  the  type  of the test.  The printed segment number is
  733.               only relevant when a test fails in the third or later test  seg-
  734.               ment.  It identifies the test that failed and consists of either
  735.               the number of the segment that failed during the  test,  or  the
  736.               number  of the test that failed and the number of the segment in
  737.               which the test  was  run,  using  a  vendor-specific  method  of
  738.               putting  both  numbers  into  a  single byte.  The Logical Block
  739.               Address (LBA) of the first error is printed in hexadecimal nota-
  740.               tion.   On Linux systems the smartmontools web page has instruc-
  741.               tions about how to convert this LBA address to the name  of  the
  742.               disk file containing the erroneous block.  If provided, the SCSI
  743.               Sense Key (SK), Additional Sense Code (ASC) and Additional Sense
  744.               Code Qualifier (ASQ) are also printed. The self tests can be run
  745.               using the '-t' option described below (using the ATA test termi-
  746.               nology).
  747.  
  748.               selective  [ATA]  -  Some  ATA-7  disks  (example:  Maxtor) also
  749.               maintain a selective self-test log.  Please see the '-t  select'
  750.               option  below  for  a  description of selective self-tests.  The
  751.               selective  self-test  log  shows  the  start/end  Logical  Block
  752.               Addresses  (LBA)  of each of the five test spans, and their cur-
  753.               rent test status.  If the span is being tested or the  remainder
  754.               of  the  disk  is  being  read-scanned, the current 65536-sector
  755.               block of LBAs being tested is  also  displayed.   The  selective
  756.               self-test  log also shows if a read-scan of the remainder of the
  757.               disk will be carried out after the selective self-test has  com-
  758.               pleted  (see  '-t afterselect' option) and the time delay before
  759.               restarting this read-scan if it is interrupted (see '-t pending'
  760.               option).  This  is  a  new  smartmontools feature; please report
  761.               unusual or incorrect behavior to the smartmontools-support mail-
  762.               ing list.
  763.  
  764.               directory  -  if the device supports the General Purpose Logging
  765.               feature set (ATA-6 and ATA-7 only)  then  this  prints  the  Log
  766.               Directory  (the log at address 0).  The Log Directory shows what
  767.               logs are available and their length in sectors (512 bytes).  The
  768.               contents  of the logs at address 1 [Summary SMART error log] and
  769.               at address 6 [SMART self-test log] may be printed using the pre-
  770.               viously-described  error  and selftest arguments to this option.
  771.               [Please note: this is a new,  experimental  feature.   We  would
  772.               like  to  add  support for printing the contents of extended and
  773.               comprehensive SMART self-test and error logs.  If your disk sup-
  774.               ports  these,  and  you would like to assist, please contact the
  775.               smartmontools developers.]
  776.  
  777.               background [SCSI] - the  background  scan  results  log  outputs
  778.               information derived from Background Media Scans (BMS) done after
  779.               power up and/or periodocally (e.g.  every 24  hours)  on  recent
  780.               SCSI  disks. If supported, the BMS status is output first, indi-
  781.               cating whether a background scan is currently underway  (and  if
  782.               so  a progress percentage), the amount of time the disk has been
  783.               powered up and the number of scans already completed. Then there
  784.               is  a  header and a line for each background scan "event". These
  785.               will typically be either recovered or unrecoverable errors. That
  786.               latter  group may need some attention. There is a description of
  787.               the background scan mechansim in section 4.18 of SBC-3  revision
  788.               6 (see www.t10.org ).
  789.  
  790.  
  791.        -v N,OPTION, --vendorattribute=N,OPTION
  792.               Sets  a  vendor-specific  display  OPTION for Attribute N.  This
  793.               option may be used  multiple  times.  Valid  arguments  to  this
  794.               option are:
  795.  
  796.               help  - Prints (to STDOUT) a list of all valid arguments to this
  797.               option, then exits.
  798.  
  799.               9,minutes - Raw Attribute number 9 is power-on time in  minutes.
  800.               Its  raw value will be displayed in the form "Xh+Ym".  Here X is
  801.               hours, and Y is minutes in  the  range  0-59  inclusive.   Y  is
  802.               always  printed  with  two  digits,  for example "06" or "31" or
  803.               "00".
  804.  
  805.               9,seconds - Raw Attribute number 9 is power-on time in  seconds.
  806.               Its  raw value will be displayed in the form "Xh+Ym+Zs".  Here X
  807.               is hours, Y is minutes in the range 0-59  inclusive,  and  Z  is
  808.               seconds in the range 0-59 inclusive.  Y and Z are always printed
  809.               with two digits, for example "06" or "31" or "00".
  810.  
  811.               9,halfminutes - Raw Attribute number 9 is  power-on  time,  mea-
  812.               sured  in units of 30 seconds.  This format is used by some Sam-
  813.               sung disks.  Its  raw  value  will  be  displayed  in  the  form
  814.               "Xh+Ym".   Here  X  is hours, and Y is minutes in the range 0-59
  815.               inclusive.  Y is always printed with  two  digits,  for  example
  816.               "06" or "31" or "00".
  817.  
  818.               9,temp  - Raw Attribute number 9 is the disk temperature in Cel-
  819.               sius.
  820.  
  821.               192,emergencyretractcyclect - Raw Attribute number  192  is  the
  822.               Emergency Retract Cycle Count.
  823.  
  824.               193,loadunload  -  Raw Attribute number 193 contains two values.
  825.               The first is the number of load cycles.  The second is the  num-
  826.               ber  of  unload cycles.  The difference between these two values
  827.               is the number of times that the drive was  unexpectedly  powered
  828.               off  (also  called an emergency unload). As a rule of thumb, the
  829.               mechanical stress created by one emergency unload is  equivalent
  830.               to that created by one hundred normal unloads.
  831.  
  832.               194,10xCelsius  - Raw Attribute number 194 is ten times the disk
  833.               temperature in Celsius.  This is  used  by  some  Samsung  disks
  834.               (example: model SV1204H with RK100-13 firmware).
  835.  
  836.               194,unknown  - Raw Attribute number 194 is NOT the disk tempera-
  837.               ture, and its interpretation is unknown. This is primarily  use-
  838.               ful for the -P (presets) option.
  839.  
  840.               198,offlinescanuncsectorct  -  Raw  Attribute  number 198 is the
  841.               Offline Scan UNC Sector Count.
  842.  
  843.               200,writeerrorcount - Raw Attribute  number  200  is  the  Write
  844.               Error Count.
  845.  
  846.               201,detectedtacount  -  Raw Attribute number 201 is the Detected
  847.               TA Count.
  848.  
  849.               220,temp - Raw Attribute number 220 is the disk  temperature  in
  850.               Celsius.
  851.  
  852.               Note: a table of hard drive models, listing which Attribute cor-
  853.               responds    to     temperature,     can     be     found     at:
  854.               http://www.guzu.net/linux/hddtemp.db
  855.  
  856.               N,raw8  -  Print  the  Raw  value  of  Attribute  N as six 8-bit
  857.               unsigned base-10 integers.  This may be useful for decoding  the
  858.               meaning  of  the Raw value.  The form 'N,raw8' prints Raw values
  859.               for ALL  Attributes  in  this  form.   The  form  (for  example)
  860.               '123,raw8'  only  prints the Raw value for Attribute 123 in this
  861.               form.
  862.  
  863.               N,raw16 - Print the Raw value of Attribute  N  as  three  16-bit
  864.               unsigned  base-10 integers.  This may be useful for decoding the
  865.               meaning of the Raw value.  The form 'N,raw16' prints Raw  values
  866.               for  ALL  Attributes  in  this  form.   The  form  (for example)
  867.               '123,raw16' only prints the Raw value for Attribute 123 in  this
  868.               form.
  869.  
  870.               N,raw48  -  Print  the  Raw  value  of  Attribute  N as a 48-bit
  871.               unsigned base-10 integer.  This may be useful for  decoding  the
  872.               meaning  of the Raw value.  The form 'N,raw48' prints Raw values
  873.               for ALL  Attributes  in  this  form.   The  form  (for  example)
  874.               '123,raw48'  only prints the Raw value for Attribute 123 in this
  875.               form.
  876.  
  877.  
  878.        -F TYPE, --firmwarebug=TYPE
  879.               Modifies the behavior of smartctl to compensate for  some  known
  880.               and  understood  device  firmware  bug.   The  arguments to this
  881.               option are exclusive, so that only the  final  option  given  is
  882.               used.  The valid values are:
  883.  
  884.               none  - Assume that the device firmware obeys the ATA specifica-
  885.               tions.  This is the default, unless the device has  presets  for
  886.               '-F' in the device database (see note below).
  887.  
  888.               samsung - In some Samsung disks (example: model SV4012H Firmware
  889.               Version: RM100-08) some of the two- and four-byte quantities  in
  890.               the  SMART data structures are byte-swapped (relative to the ATA
  891.               specification).  Enabling this option tells smartctl to evaluate
  892.               these  quantities  in byte-reversed order.  Some signs that your
  893.               disk needs this option are (1) no self-test  log  printed,  even
  894.               though  you  have  run self-tests; (2) very large numbers of ATA
  895.               errors reported in the ATA error log; (3) strange and impossible
  896.               values for the ATA error log timestamps.
  897.  
  898.               samsung2 - In more recent Samsung disks (firmware revisions end-
  899.               ing in "-23") the number of ATA errors reported is byte swapped.
  900.               Enabling this option tells smartctl to evaluate this quantity in
  901.               byte-reversed order. An indication that your Samsung disk  needs
  902.               this  option is that the self-test log is printed correctly, but
  903.               there are a very large number of errors in the SMART error  log.
  904.               This  is  because  the error count is byte swapped.  Thus a disk
  905.               with five errors (0x0005)  will  appear  to  have  20480  errors
  906.               (0x5000).
  907.  
  908.               Note  that  an  explicit  '-F'  option  on the command line will
  909.               over-ride any preset  values  for  '-F'  (see  the  '-P'  option
  910.               below).
  911.  
  912.  
  913.        -P TYPE, --presets=TYPE
  914.               Specifies  whether  smartctl  should use any preset options that
  915.               are available for this drive. By default, if the drive is recog-
  916.               nized  in the smartmontools database, then the presets are used.
  917.  
  918.               smartctl can automatically set  appropriate  options  for  known
  919.               drives.   For  example,  the  Maxtor 4D080H4 uses Attribute 9 to
  920.               stores power-on time in minutes whereas  most  drives  use  that
  921.               Attribute to store the power-on time in hours.  The command-line
  922.               option '-v 9,minutes' ensures that smartctl correctly interprets
  923.               Attribute 9 in this case, but that option is preset for the Max-
  924.               tor 4D080H4 and so need not be specified  by  the  user  on  the
  925.               smartctl command line.
  926.  
  927.               The  argument  show  will show any preset options for your drive
  928.               and the argument showall will  show  all  known  drives  in  the
  929.               smartmontools  database,  along  with  their preset options.  If
  930.               there are no presets for your drive and you think  there  should
  931.               be  (for example, a -v or -F option is needed to get smartctl to
  932.               display correct values) then please  contact  the  smartmontools
  933.               developers  so  that this information can be added to the smart-
  934.               montools database.  Contact information is at the  end  of  this
  935.               man page.
  936.  
  937.               The valid arguments to this option are:
  938.  
  939.               use  - if a drive is recognized, then use the stored presets for
  940.               it.  This is the default. Note that presets will  NOT  over-ride
  941.               additional  Attribute  interpretation  ('-v  N,something')  com-
  942.               mand-line options or explicit '-F' command-line options..
  943.  
  944.               ignore - do not use presets.
  945.  
  946.               show - show if the drive is recognized in the database,  and  if
  947.               so, its presets, then exit.
  948.  
  949.               showall  -  list all recognized drives, and the presets that are
  950.               set for them, then exit.
  951.  
  952.               The '-P showall' option takes up to two  optional  arguments  to
  953.               match a specific drive type and firmware version. The command:
  954.                 smartctl -P showall
  955.               lists all entries, the command:
  956.                 smartctl -P showall 'MODEL'
  957.               lists all entries matching MODEL, and the command:
  958.                 smartctl -P showall 'MODEL' 'FIRMWARE'
  959.               lists  all  entries  for this MODEL and a specific FIRMWARE ver-
  960.               sion.
  961.  
  962.  
  963.        SMART RUN/ABORT OFFLINE TEST AND SELF-TEST OPTIONS:
  964.  
  965.        -t TEST, --test=TEST
  966.               Executes TEST immediately.  The '-C' option can be used in  con-
  967.               junction with this option to run the short or long (and also for
  968.               ATA devices, selective or conveyance) self-tests in captive mode
  969.               (known  as  "foreground mode" for SCSI devices).  Note that only
  970.               one test type can be run at a time, so only one test type should
  971.               be  specified per command line.  Note also that if a computer is
  972.               shutdown or power cycled during  a  self-test,  no  harm  should
  973.               result.   The  self-test  will  either be aborted or will resume
  974.               automatically.
  975.  
  976.               The valid arguments to this option are:
  977.  
  978.               offline - runs SMART Immediate Offline Test.   This  immediately
  979.               starts the test described above.  This command can be given dur-
  980.               ing normal system operation.  The effects of this test are visi-
  981.               ble  only  in that it updates the SMART Attribute values, and if
  982.               errors are found they will appear in the SMART error log,  visi-
  983.               ble  with  the  '-l  error' option. [In the case of SCSI devices
  984.               runs the default self test in foreground. No entry is placed  in
  985.               the self test log.]
  986.  
  987.               If  the  '-c'  option  to smartctl shows that the device has the
  988.               "Suspend Offline collection upon new  command"  capability  then
  989.               you  can  track the progress of the Immediate Offline test using
  990.               the '-c' option to smartctl.  If the '-c' option show  that  the
  991.               device has the "Abort Offline collection upon new command" capa-
  992.               bility then most commands will abort the Immediate Offline Test,
  993.               so  you  should  not  try to track the progress of the test with
  994.               '-c', as it will abort the test.
  995.  
  996.               short - runs SMART Short Self Test (usually under ten  minutes).
  997.               [Note: in the case of SCSI devices, this command option runs the
  998.               "Background short" self-test.]  This command can be given during
  999.               normal  system  operation  (unless run in captive mode - see the
  1000.               '-C' option below).  This is a test in a different category than
  1001.               the  immediate  or  automatic  offline  tests.  The "Self" tests
  1002.               check the electrical and mechanical performance as well  as  the
  1003.               read performance of the disk.  Their results are reported in the
  1004.               Self Test Error Log, readable with  the  '-l  selftest'  option.
  1005.               Note  that  on  some  disks the progress of the self-test can be
  1006.               monitored by watching this log during the self-test; with  other
  1007.               disks use the '-c' option to monitor progress.
  1008.  
  1009.               long  - runs SMART Extended Self Test (tens of minutes).  [Note:
  1010.               in the case of SCSI devices, this command option runs the "Back-
  1011.               ground  long"  self-test.]   This  is a longer and more thorough
  1012.               version of the Short Self Test described above.  Note that  this
  1013.               command  can be given during normal system operation (unless run
  1014.               in captive mode - see the '-C' option below).
  1015.  
  1016.               conveyance - [ATA ONLY] runs a SMART Conveyance Self Test  (min-
  1017.               utes).   This  self-test  routine is intended to identify damage
  1018.               incurred during transporting of the device. This self-test  rou-
  1019.               tine should take on the order of minutes to complete.  Note that
  1020.               this command can be given during normal system operation (unless
  1021.               run in captive mode - see the '-C' option below).
  1022.  
  1023.               select,N-M - [ATA ONLY] [NEW EXPERIMENTAL SMARTCTL FEATURE] runs
  1024.               a SMART Selective Self Test, to test a  range  of  disk  Logical
  1025.               Block Addresses (LBAs), rather than the entire disk.  Each range
  1026.               of LBAs that is checked is called a "span" and is specified by a
  1027.               starting LBA (N) and an ending LBA (M) with N less than or equal
  1028.               to M.  For example the command:
  1029.                 smartctl -t select,10-20 /dev/hda
  1030.               runs a self test on one span consisting of LBAs  ten  to  twenty
  1031.               (inclusive).  The  '-t' option can be given up to five times, to
  1032.               test up to five spans.  For example the command:
  1033.                 smartctl -t select,0-100 -t select,1000-2000 /dev/hda
  1034.               runs a self test on two spans.  The first span consists  of  101
  1035.               LBAs  and  the second span consists of 1001 LBAs.  Note that the
  1036.               spans can overlap partially or completely, for example:
  1037.                 smartctl -t select,0-10 -t select,5-15 -t select,10-20 /dev/hda
  1038.               The results of the selective self-test  can  be  obtained  (both
  1039.               during  and after the test) by printing the SMART self-test log,
  1040.               using the '-l selftest' option to smartctl.
  1041.  
  1042.               Selective self tests are particularly useful as disk  capacities
  1043.               increase: an extended self test (smartctl -t long) can take sev-
  1044.               eral hours.  Selective self-tests are helpful if (based on  SYS-
  1045.               LOG  error  messages, previous failed self-tests, or SMART error
  1046.               log entries) you suspect that a disk is  having  problems  at  a
  1047.               particular range of Logical Block Addresses (LBAs).
  1048.  
  1049.               Selective  self-tests  can be run during normal system operation
  1050.               (unless done in captive mode - see the '-C' option below).
  1051.  
  1052.               [Note: this new experimental smartmontools feature is  currently
  1053.               only  available  under Linux.  The Linux kernel must be compiled
  1054.               with the configuration  option  CONFIG_IDE_TASKFILE_IO  enabled.
  1055.               Please  report  unusual  or  incorrect behavior to the smartmon-
  1056.               tools-support mailing list.]
  1057.  
  1058.               afterselect,on - [ATA ONLY] perform an offline read scan after a
  1059.               Selective  Self-test  has  completed.  This  option must be used
  1060.               together with one or more of the select,N-M  options  above.  If
  1061.               the  LBAs  that  have  been specified in the Selective self-test
  1062.               pass the test with no errors found, then read scan the remainder
  1063.               of  the  disk.   If the device is powered-cycled while this read
  1064.               scan is in progress, the read scan will be automatically resumed
  1065.               after  a  time  specified by the pending timer (see below).  The
  1066.               value of this option is preserved between selective  self-tests.
  1067.  
  1068.               afterselect,off  -  [ATA ONLY] do not read scan the remainder of
  1069.               the disk after a Selective self-test has completed.  This option
  1070.               must  be use together with one or more of the select,N-M options
  1071.               above.  The value of this option is preserved between  selective
  1072.               self-tests.
  1073.  
  1074.               pending,N  -  [ATA ONLY] set the pending offline read scan timer
  1075.               to N minutes.  Here N is an integer in the range from 0 to 65535
  1076.               inclusive.   If  the  device  is  powered off during a read scan
  1077.               after a Selective self-test, then resume the test  automatically
  1078.               N minutes after power-up.  This option must be use together with
  1079.               one or more of the select,N-M options above. The value  of  this
  1080.               option is preserved between selective self-tests.
  1081.  
  1082.  
  1083.        -C, --captive
  1084.               Runs  self-tests  in  captive mode.  This has no effect with '-t
  1085.               offline' or if the '-t' option is not used. [Note: in  the  case
  1086.               of  SCSI  devices,  this  command  option  runs the self-test in
  1087.               "Foreground" mode.]
  1088.  
  1089.               WARNING: Tests run in captive mode may busy out  the  drive  for
  1090.               the  length of the test.  Only run captive tests on drives with-
  1091.               out any mounted partitions!
  1092.  
  1093.  
  1094.        -X, --abort
  1095.               Aborts non-captive SMART Self Tests.   Note  that  this  command
  1096.               will  abort the Offline Immediate Test routine only if your disk
  1097.               has the "Abort Offline collection upon new command"  capability.
  1098.  
  1099.  
  1100. EXAMPLES
  1101.        smartctl -a /dev/hda
  1102.        Print all SMART information for drive /dev/hda (Primary Master).
  1103.  
  1104.        smartctl -s off /dev/hdd
  1105.        Disable SMART on drive /dev/hdd (Secondary Slave).
  1106.  
  1107.        smartctl --smart=on --offlineauto=on --saveauto=on /dev/hda
  1108.        Enable  SMART on drive /dev/hda, enable automatic offline testing every
  1109.        four hours, and enable autosaving of SMART Attributes.  This is a  good
  1110.        start-up line for your system's init files.  You can issue this command
  1111.        on a running system.
  1112.  
  1113.        smartctl -t long /dev/hdc
  1114.        Begin an extended self-test of drive /dev/hdc.  You can issue this com-
  1115.        mand on a running system.  The results can be seen in the self-test log
  1116.        visible with the '-l selftest' option after it has completed.
  1117.  
  1118.        smartctl -s on -t offline /dev/hda
  1119.        Enable SMART on the disk, and begin an immediate offline test of  drive
  1120.        /dev/hda.  You can issue this command on a running system.  The results
  1121.        are only used to update the SMART Attributes,  visible  with  the  '-A'
  1122.        option.  If any device errors occur, they are logged to the SMART error
  1123.        log, which can be seen with the '-l error' option.
  1124.  
  1125.        smartctl -A -v 9,minutes /dev/hda
  1126.        Shows the vendor Attributes, when the disk  stores  its  power-on  time
  1127.        internally in minutes rather than hours.
  1128.  
  1129.        smartctl -q errorsonly -H -l selftest /dev/hda
  1130.        Produces  output only if the device returns failing SMART status, or if
  1131.        some of the logged self-tests ended with errors.
  1132.  
  1133.        smartctl -q silent -a /dev/hda
  1134.        Examine all SMART data for device /dev/hda, but produce no printed out-
  1135.        put.  You must use the exit status (the $?  shell variable) to learn if
  1136.        any Attributes are out of bound, if the SMART  status  is  failing,  if
  1137.        there  are errors recorded in the self-test log, or if there are errors
  1138.        recorded in the disk error log.
  1139.  
  1140.        smartctl -a -d 3ware,0 /dev/sda
  1141.        Examine all SMART data for the first ATA disk connected to a 3ware RAID
  1142.        controller card.
  1143.  
  1144.        smartctl -a -d 3ware,0 /dev/twe0
  1145.        Examine all SMART data for the first ATA disk connected to a 3ware RAID
  1146.        6000/7000/8000 controller card.
  1147.  
  1148.        smartctl -a -d 3ware,0 /dev/twa0
  1149.        Examine all SMART data for the first ATA disk connected to a 3ware RAID
  1150.        9000 controller card.
  1151.  
  1152.        smartctl -t short -d 3ware,3 /dev/sdb
  1153.        Start  a  short self-test on the fourth ATA disk connected to the 3ware
  1154.        RAID controller card which is the second SCSI device /dev/sdb.
  1155.  
  1156.        smartctl -a -d hpt,1/3 /dev/sda
  1157.        Examine all SMART data for the (S)ATA disk directly  connected  to  the
  1158.        third channel of the first HighPoint RocketRAID controller card.
  1159.  
  1160.        smartctl -t short -d hpt,1/1/2 /dev/sda
  1161.        Start  a  short self-test on the (S)ATA disk connected to second pmport
  1162.        on the first channel of the first HighPoint RocketRAID controller card.
  1163.  
  1164.        smartctl -t select,10-100 -t select,30-300 -t afterselect,on -t pending,45 /dev/hda
  1165.        Run  a  selective self-test on LBAs 10 to 100 and 30 to 300.  After the
  1166.        these LBAs have been tested, read-scan the remainder of the  disk.   If
  1167.        the  disk is power-cycled during the read-scan, resume the scan 45 min-
  1168.        utes after power to the device is restored.
  1169.  
  1170.        smartctl -a -d cciss,0 /dev/cciss/c0d0
  1171.        Examine all SMART data for the first SCSI disk  connected  to  a  cciss
  1172.        RAID controller card.
  1173.  
  1174.  
  1175. RETURN VALUES
  1176.        The return values of smartctl are defined by a bitmask.  If all is well
  1177.        with the disk, the return value (exit status) of  smartctl  is  0  (all
  1178.        bits  turned  off).  If a problem occurs, or an error, potential error,
  1179.        or fault is detected, then a non-zero  status  is  returned.   In  this
  1180.        case,  the  eight different bits in the return value have the following
  1181.        meanings for ATA disks; some of these values may also be  returned  for
  1182.        SCSI disks.
  1183.  
  1184.        Bit 0: Command line did not parse.
  1185.  
  1186.        Bit 1: Device  open failed, or device did not return an IDENTIFY DEVICE
  1187.               structure.
  1188.  
  1189.        Bit 2: Some SMART command to the disk failed, or there was  a  checksum
  1190.               error in a SMART data structure (see '-b' option above).
  1191.  
  1192.        Bit 3: SMART status check returned "DISK FAILING".
  1193.  
  1194.        Bit 4: SMART  status  check  returned  "DISK  OK"  but we found prefail
  1195.               Attributes <= threshold.
  1196.  
  1197.        Bit 5: SMART status check returned "DISK OK" but  we  found  that  some
  1198.               (usage  or  prefail)  Attributes  have been <= threshold at some
  1199.               time in the past.
  1200.  
  1201.        Bit 6: The device error log contains records of errors.
  1202.  
  1203.        Bit 7: The device self-test log contains records of errors.
  1204.  
  1205.               To test within the shell for whether or not the  different  bits
  1206.               are  turned  on  or  off, you can use the following type of con-
  1207.               struction (this is bash syntax):
  1208.               smartstat=$(($? & 8))
  1209.               This looks at only at bit  3  of  the  exit  status  $?   (since
  1210.               8=2^3).   The shell variable $smartstat will be nonzero if SMART
  1211.               status check returned "disk failing" and zero otherwise.
  1212.  
  1213.  
  1214.  
  1215. NOTES
  1216.        The TapeAlert log page flags are cleared for  the  initiator  when  the
  1217.        page  is  read.  This  means that each alert condition is reported only
  1218.        once by smartctl for each initiator for each activation of  the  condi-
  1219.        tion.
  1220.  
  1221.  
  1222.  
  1223. AUTHOR
  1224.        Bruce Allen smartmontools-support@lists.sourceforge.net
  1225.        University of Wisconsin - Milwaukee Physics Department
  1226.  
  1227.  
  1228.  
  1229. CONTRIBUTORS
  1230.        The following have made large contributions to smartmontools:
  1231.        Casper Dik (Solaris SCSI interface)
  1232.        Christian Franke (Windows interface and Cygwin package)
  1233.        Douglas Gilbert (SCSI subsystem)
  1234.        Guido Guenther (Autoconf/Automake packaging)
  1235.        Geoffrey Keating (Darwin ATA interface)
  1236.        Eduard Martinescu (FreeBSD interface)
  1237.        Frederic L. W. Meunier (Web site and Mailing list)
  1238.        Keiji Sawada (Solaris ATA interface)
  1239.        Sergey Svishchev (NetBSD interface)
  1240.        David Snyder and Sergey Svishchev (OpenBSD interface)
  1241.        Phil Williams (User interface and drive database)
  1242.        Yuri Dario (OS/2, eComStation interface)
  1243.        Shengfeng Zhou (Linux Highpoint RocketRaid interface)
  1244.        Many other individuals have made smaller contributions and corrections.
  1245.  
  1246.  
  1247.  
  1248. CREDITS
  1249.        This code was derived from the smartsuite package, written  by  Michael
  1250.        Cornwell,  and  from  the previous UCSC smartsuite package.  It extends
  1251.        these to cover ATA-5 disks.  This code was originally  developed  as  a
  1252.        Senior  Thesis by Michael Cornwell at the Concurrent Systems Laboratory
  1253.        (now part of the Storage Systems Research Center), Jack  Baskin  School
  1254.        of    Engineering,    University    of    California,    Santa    Cruz.
  1255.        http://ssrc.soe.ucsc.edu/ .
  1256.  
  1257. HOME PAGE FOR SMARTMONTOOLS:
  1258.        Please see the following web site for updates,  further  documentation,
  1259.        bug reports and patches: http://smartmontools.sourceforge.net/
  1260.  
  1261.  
  1262. SEE ALSO:
  1263.        smartd(8), badblocks(8), ide-smart(8).
  1264.  
  1265. REFERENCES FOR SMART
  1266.        An  introductory  article  about smartmontools is Monitoring Hard Disks
  1267.        with SMART, by Bruce Allen, Linux Journal, January 2004,  pages  74-77.
  1268.        This is http://www.linuxjournal.com/article.php?sid=6983 online.
  1269.  
  1270.        If  you  would  like  to understand better how SMART works, and what it
  1271.        does, a good place to start is with Sections 4.8 and 6.54 of the  first
  1272.        volume  of  the  'AT  Attachment with Packet Interface-7' (ATA/ATAPI-7)
  1273.        specification.  This documents the SMART functionality which the smart-
  1274.        montools utilities provide access to.  You can find Revision 4b of this
  1275.        document  at  http://www.t13.org/docs2004/d1532v1r4b-ATA-ATAPI-7.pdf  .
  1276.        Earlier and later versions of this Specification are available from the
  1277.        T13 web site http://www.t13.org/ .
  1278.  
  1279.        The functioning of SMART was originally defined by the SFF-8035i  revi-
  1280.        sion 2 and the SFF-8055i revision 1.4 specifications.  These are publi-
  1281.        cations of the Small Form Factors (SFF) Committee.  Links to these doc-
  1282.        uments may be found in the References section of the smartmontools home
  1283.        page at http://smartmontools.sourceforge.net/ .
  1284.  
  1285.  
  1286. CVS ID OF THIS PAGE:
  1287.        $Id: smartctl.8.in,v 1.90 2006/12/20 07:30:43 sxzzsf Exp $
  1288.  
  1289.  
  1290.  
  1291. smartmontools-5.37                2006/12/20                       SMARTCTL(8)
  1292.